
Groupe de commandes "CLIP": Presse-papiers
==========================================

RK offre une srie de commandes qui manipule le contenu du presse-papiers.


/CLIP.CALC [mod] ......: Calcule le contenu du presse-papiers (s'il est 
                         en "liste" = colonne), <mod>=1: calcule la 
------------------------ moyenne, <mod>=2: calcule en heures

Quand une liste de chiffres est sous forme de colonne dans le presse-
papiers, cette commande peut calculer le rsultat, que cela soit une 
addition, soustraction, multiplication (*), division (/) et pourcent 
(% : doit se trouver  la fin).
Si aucun oprateur n'est donn, c'est l'addition qui sera effectue.
Depuis la version 7.7.61, "ClipCalc" est un programme unique qui se trouve 
dans le sous-dossier "App". Si le paramtre "1" est ajout, le rsultat de 
l'addition sera galement donn sous forme de moyenne (quand c'est 
possible). Si le paramtre "2" est ajout, le rsultat sera calcul en 
heures et minutes.

Exemple: bouton "=" du profil "Calculatrice du scnario"
Exemple pour mode 1: bouton "" du profil "Calculatrice du scnario"
Exemple pour mode 2: bouton droit "=" du profil "Calculatrice du scnario"

Exemple de scnario:
1. Crez un bouton avec le scnario suivant:

{/BTCH.EXPLICIT}
{/CLIP.CALC}
{/CLIP.TXT.VIEW}

2. Maintenant copiez le bloque suivant dans le presse-papiers

44.50
17.33
112.05

3. Cliquez sur le bouton nouvellement cr.

--> Conseil
Cela fonctionne aussi si une colonne dans Excel est copie dans le presse-
papiers.

--> Note
Le rsultat est automatiquement stock dans la variable VAR actuelle 
("Dfinition VAR") pour des calculations additionelles. (voir le bouton 
"VAR" du profil "Calculatrice du scnario")

--> Note
Le profil "Calculatrice du scnario" est bas sur ce principe, ainsi c'est 
possible de coder une calculatrice complte avec des scnarios.


/CLIP.CLEAR ...........: Efface le presse-papiers
------------------------

Exemple: bouton "eff. pr-pa" du profil "Stock"


/CLIP.COPYPATH ........: Copie un chemin dans le presse-papiers en 
                         utilisant l'utilitaire "FileDuplicate", option 
------------------------ "Copy a Path..."

Depuis "l'Explorateur", glissez un fichier et dplacez-le sur l'image.
Le texte s'affiche dans le champ "Clipboard" suivant l'une des 3 options 
choisies : "Chemin et Nom de fichier", "Chemin seulement" ou "Nom de 
fichier seulement" et est copi dans le presse-papiers.

Exemple: {/CLIP.COPYPATH}


/CLIP.IMG.LOAD file....: Copie les fichiers images dans le presse-papiers
------------------------
Avec cette commande on peut envoyer une image (bmp, jpg, gif) dans le 
presse-papiers, puis immdiatement aprs la coller dans une application.

Exemple: {/CLIP.IMG.LOAD c:\mes documents\mes images\lion.jpg}


/CLIP.IMG.MEM no ......: Charge une image <no> (1-10) de la bote 
------------------------ "Mmoire des images" dans le presse-papiers

La bote "Mmoire des images" (s.v.p. lisez le fichier-texte) peut 
contenir 10 images. Cette commande permet d'envoyer une des 10 images 
dans le presse-papiers.

Exemple: bouton "image" du profil "Stock"


/CLIP.IMG.VIEW ........: Affiche l'image, charge dans le presse-papiers 
                         avec "/CLIP.IMG.LOAD file", dans l'Aperu 
------------------------ interne d'image

Exemple: {/CLIP.IMG.VIEW}


/CLIP.TXT.APPEND file .: Ajoute au fichier-texte <file> le texte contenu 
------------------------ dans le presse-papiers

Exemple de scnario: 

1. Crez un fichier-texte nomm "essai" dans C:\Mes Documents, puis tapez 
   quelques mots et fermez-le.
2. Crez un bouton avec la commande : 
   {/CLIP.TXT.APPEND c:\mes documents\essai.txt}
3. Copiez un texte dans le presse-papiers, puis cliquez sur le bouton.
4. Ouvrez "essai" : le texte a t coll.


/CLIP.TXT.ASK .........: Ajoute un texte dans le presse-papiers, crit par 
------------------------ l'utilisateur pendant le processus du scnario

Exemple: bouton "Ex - Clip" du profil "Dmo scnarios Go-Exit" 
         bouton "Go - Clip" du profil "Dmo scnarios Go-Exit"

--> Conseil
L'excution du scnario peut tre interrompue  l'aide de la commande 
"BTCH.EXITIF.CANCEL" si la bote est ferme avec le bouton "Ferme".


/CLIP.TXT.BEFOR txt....: Ajoute un texte <txt> au dbut du presse-papiers
/CLIP.TXT.BEHND txt....: Ajoute un texte <txt>  la fin du presse-papiers
------------------------

Avec ces commandes on peut par exemple copi un texte dans le presse-
papiers aprs l'avoir vid.

Exemple: {/CLIP.CLEAR}{/CLIP.TXT.BEFOR Bonjour tout le monde}

Dans cet exemple il ne reste que le texte "Bonjour tout le monde" dans le 
presse-papiers. 

Autres exemples: boutons "avant" et "aprs" du profil "Stock"


/CLIP.TXT.BEHND.ASC no : Ajoute un code ASCII <no>  la fin du presse-p.
/CLIP.TXT.BEHND.ASK ...: Ajoute un texte  la fin du presse-p., dfini par 
                         l'utilisateur pendant le processus du scnario
/CLIP.TXT.BEHND.CR ....: Ajoute un "retour  la ligne"  la fin du presse-p.
/CLIP.TXT.BEHND.MEM ...: Ajoute la mmoire du presse-papiers de RK  la fin 
                         du presse-papiers
/CLIP.TXT.BEHND.STR [n]: Ajoute la variable-srie STR <n>  la fin du 
                         presse-papiers
/CLIP.TXT.BEHND.VAR ...: Ajoute la variable VAR actuelle  la fin du 
------------------------ presse-papiers

Exemple ..BEHND.ASK: bouton "Com." du profil "Calculatrice du scnario"

Exemple ..BEHND.CR: bouton "Vers le pres.-p." du profil "Exemples de base 
                    de donnes"

--> Conseil
Pour la commande BEHND.ASK, l'excution du scnario peut tre interrompue 
 l'aide de la commande "BTCH.EXITIF.CANCEL" si la bote est ferme avec 
le bouton "Ferme".


/CLIP.TXT.BLOCK.BEGIN .: Marque le dbut d'un bloc de texte du scnario 
                         qui sera copi dans le presse-papiers
/CLIP.TXT.BLOCK.END ...: Marque la fin du bloc de texte pour ..BLOCK.BEGIN 
------------------------ (facultative : si = non, le scnario prend fin)

Ces commandes permettent de copier un bloc de texte du scnario dans le 
presse-papiers.
La commande BLOCK.END n'est pas obligatoire. Si elle manque, le scnario 
prendra automatiquement fin  ce point.

Exemple: bouton "Note" du profil "Stock"

Exemple de scnario:

{/CLIP.TXT.BLOCK.BEGIN}
Ligne 1
Ligne 2

Exemple de scnario:

{/CLIP.TXT.BLOCK.BEGIN}
Ligne 1 et
Ligne 2 viennent du presse-papiers...{/CLIP.TXT.BLOCK.END}
{/BTCH.EXPLICIT}
{HOLD.CONTROL}v
{KEY.ENTER}
Ligne 3 est envoye directement.

--> Remarque !
La commande BTCH.EXPLICIT assure un bon rsultat, car elle supprime du 
scnario les retours  la ligne indsirs.

--> Conseil
La combinaison de ces commandes permet galement de marquer un bloc  
l'intrieur du scnario, qui ne doit pas tre envoy.

Exemple de scnario:

Cette ligne est envoye.
{/CLIP.TXT.BLOCK.BEGIN}
Cette ligne n'est pas envoye.
{/CLIP.TXT.BLOCK.END}{/BTCH.EXPLICIT}
Cette ligne est galement envoye.


/CLIP.TXT.CONV [mod] ..: Convertit dans le presse-papiers les valeurs en 
                         caractres, <mod>=0: dc>hex, <mod>=1: hex>dc 
------------------------ (dfaut=0)

Exemple: bouton "d>H" du profil "Calculatrice du scnario"

Si le chiffre "234" se trouve dans le presse-papiers, il devient "EA" 
aprs l'excution de cette commande.


/CLIP.TXT.COUNT .......: Compte les caractres contenus dans le 
------------------------ presse-papiers

Dans beaucoup de formulaires Internet la requte est limite  un nombre 
dfini de caractres. Quand des textes sont rdigs pour des formulaires 
diffrents c'est trs utile de trouver rapidement le nombre de caractres 
de ceux-ci : simplement en les copiant dans le presse-papiers puis en 
utilisant cette commande.

Exemple: bouton "Compte" du profil "Stock"


/CLIP.TXT.CUT.LEFT qu .: Supprime dans le presse-papiers la quantit <qu> 
                         de caractres depuis la gauche
/CLIP.TXT.CUT.RGHT qu .: Supprime dans le presse-papiers la quantit <qu> 
                         de caractres depuis la droite
/CLIP.TXT.CUT.FROM pos : Supprime dans le presse-p. la droite du texte 
                         depuis le caractre n <pos> (y compris celui-ci)
/CLIP.TXT.CUT.REVERSE .: Commute entre le rsultat du presse-papiers et la 
------------------------ partie coupe de la dernire commande .CUT

Exemple de scnario:

{/BTCH.EXPLICIT}
{/STR.SET 1,1234567890}
{/STR.CLIP.SET 1}
{/CLIP.TXT.CUT.LEFT 3}
{/CLIP.TXT.CUT.FROM 5}
{/STR.CLIP.GET 1}
{/STR.VIEW}

L'aperu affiche le contenu "4567" pour la srie STR 1.

Depuis la version 8.0, le paramtre "qu" ngatif est possible. Dans ce 
cas "qu" se calcule avec la diffrence entre la longueur totale du presse-
papiers et lui-mme.
Cela signifie: si 10 chiffres se trouvent dans le presse-papiers et que 
le paramtre -3 est donn, alors 7 chiffres seront supprims.

De mme depuis la version 8.0, la commande REVERSE commute entre la partie 
coupe et le rsultat obtenu dans le presse-papiers.
Exemple: 
Dans le presse-papiers se trouve "1234567890". Avec la commande CUT.LEFT 
les 4 premiers chiffres sont effacs. Dans le presse-papiers il y a 
maintenant "567890". Si la commande REVERSE est excute, le contenu du 
presse-papiers se change en "1234".


/CLIP.TXT.ENCRYPT .....: Code le texte du presse-papiers
/CLIP.TXT.DECRYPT .....: Dcode le texte du presse-papiers
------------------------
La fonction "Code" se trouve dans la bote de l'Editeur des boutons. Donc 
comme ce module existe, ce n'tait pas un luxe de l'ajouter au presse-
papiers pour coder et dcoder des textes.
Si on dsire coder un texte-ASCII (.txt) : on le copie dans le presse-
papiers, on le code avec un mot de passe (une bote pour entrer le mot 
de passe s'ouvre automatiquement), et on le colle dans l'application.
Ainsi on peut oublier le texte et l'enlever de sa mmoire.

Si on dsire le rendre lisible  nouveau, on le copie une nouvelle fois 
dans le presse-papiers, on le dcode avec le mme mot de passe et on le 
colle dans une application-texte.

-->Attention ! 
Si le mot de passe est perdu, c'est pratiquement impossible de rendre le 
texte lisible !

Exemple: {/CLIP.TXT.ENCRYPT}


/CLIP.TXT.EDITOR ......: Ouvre le contenu du presse-papiers dans 
------------------------ l'diteur (editor.txt du sous-dossier "PicMem")

Exemple: bouton "Edit." du profil "Calculatrice du scnario"


/CLIP.TXT.END>FRONT [s]: Inverse dans le presse-p. les mots espacs de la 
                         fin au dbut, facultatif avec un sparateur <s>
/CLIP.TXT.FRONT>END [s]: Inverse dans le presse-p. les mots espacs du 
------------------------ dbut  la fin, facultatif avec un sparateur <s>

Ces commandes sont utiles pour inverser des listes de noms dans le presse-
papiers.

Exemple:

Liza Minelli
Johann Sebastian Bach

donne:

Minelli, Liza
Bach, Johann Sebastian

et sur demande comme  l'origine.

Les scnarios se prsentent ainsi:

{/BTCH.EXPLICIT}
{/CLIP.TXT.END>FRONT ,}
{/CLIP.TXT.BEHND.CR}
{/CLIP.TXT.SEND}

et

{/BTCH.EXPLICIT}
{/CLIP.TXT.REMOVE.TXT ,}
{/CLIP.TXT.FRONT>END}
{/CLIP.TXT.BEHND.CR}
{/CLIP.TXT.SEND}

--> Remarque !
Encore une fois pour tre clair :
C'est valable aussi bien pour une liste complte de noms que pour des noms 
uniques.

--> Conseil !
Si l'on place avant la commande {/CLIP.TXT.TAB>SPC 1}, on peut alors 
galement inverser la place de listes dans Excel.


/CLIP.TXT.FORMAT.DO ...: Formate la liste de calculs dans le presse-papiers
/CLIP.TXT.FORMAT.SET [n] Dfinit dans le presse-p. le mode du format <n> 
                         (-1,0,1,2,3...) : -1 = sans colonne, 0 = colonne, 
                         1 = 0.0, etc...
/CLIP.TXT.FORMAT.SYM txt Ajoute des symboles de monnaie, <txt> pour $ etc, 
------------------------ off=sans, del=supprime les symboles actuels

Ces commandes ont t dveloppes pour formater la sortie du profil 
"Calculatrice du scnario". Si l'on veut obtenir de bons rsultats dans 
CMM (l'Aperu), on doit naturellement utiliser ces commandes.

Exemple: bouton "F.on" du profil "Calculatrice du scnario"

Exemple de scnario:

{/BTCH.EXPLICIT}
{/APP.ACTIVATION.OFF}
{/CLIP.TXT.FORMAT.SYM del}
{/CLIP.TXT.FORMAT.SET 2}
{/CLIP.TXT.FORMAT.DO}
{/CLIP.TXT.FORMAT.SYM EUR}
{/CLIP.TXT.FORMAT.DO}


/CLIP.TXT.INITIAL [str]: Convertit le 1er caractre aprs un espace, TAB 
                         et retour  la ligne en majuscule, facultatif: 
------------------------ srie de caractres <str>

Exemple: {/CLIP.TXT.INITIAL}

La phrase "abc def, ghi" deviendra "Abc Def, Ghi".

Depuis la version 8.2, on peut ajouter un paramtre facultatif de srie de 
signes, qui concerne d'autres signes autres que "espace", "TAB" et "Retour 
 la ligne".
Sans le paramtre la commande va donner avec "jean-pierre" : "Jean-pierre", 
car le "trait d'union" ne rentre pas en ligne de compte.
Pour obtenir "Jean-Pierre" la commande doit tre : {/CLIP.TXT.INITIAL -}.
On peut ajouter beaucoup de caractres arbitraires, comme par exemple 
{/CLIP.TXT.INITIAL -.,}.


/CLIP.TXT.LOAD file....: Charge un fichier-texte <file> dans le presse-
------------------------ papiers

Avec cette commande on peut lire un texte-ASCII (.txt) dans le presse-
papiers (dans la liste alphabtique c'est le plus agrable), puis le 
coller ensuite dans une autre application-texte avec la commande 
/CLIP.TXT.SEND (voir plus bas).

Exemple: bouton "c. txt" du profil "Stock"


/CLIP.TXT.LOWCASE .....: Change le texte du presse-papiers en minuscules
/CLIP.TXT.UPCASE ......: Change le texte du presse-papiers en majuscules
------------------------

Exemples: boutons "minusc." et "majusc." du profil "Stock"


/CLIP.TXT.MEM.COPY ....: Copie le texte du presse-papiers dans la mmoire 
                         du presse-papiers de RK
/CLIP.TXT.MEM.SWAP ....: Permute entre le texte du presse-papiers et la 
------------------------ mmoire du presse-papiers de RK

RK possde une mmoire pour le presse-papiers, appele "ClipMemory". Avec 
la commande COPY, le contenu actuel du presse-papiers sera stock dedans, 
et la commande SWAP permutera entre le contenu du presse-papiers et de la 
mmoire.

Exemple: {/CLIP.TXT.MEM.SWAP}

--> Attention !
Aprs le 1er appel le contenu du presse-papiers est naturellement vide.

Aussi suivez la dmarche suivante :
1. Slectionnez le 1er texte et copiez-le dans le presse-papiers
2. Envoyez la commande /CLIP.TXT.MEM.COPY
3. Slectionnez le 2me texte et copiez-le dans le presse-papiers 

Maintenant vous pouvez permuter entre les 2 textes  l'aide de la 
commande /CLIP.TXT.MEM.SWAP.


/CLIP.TXT.REMOVE.ASC ..: Supprime le code-ASCII <no> du presse-papiers
/CLIP.TXT.REPLACE.ASC .: Remplace le 1er code-ASCII par le 2me
------------------------ <no>,<no> dans le presse-papiers

Exemple: {/CLIP.TXT.REMOVE.ASC 34}

Dans cet exemple toutes les apostrophes (") seront supprimes.

Exemple: {/CLIP.TXT.REPLACE.ASC 45,61}

Dans cet exemple tous les traits d'union (-) seront remplacs par des 
signes d'galit (=).

Dans le sous-dossier "App" de RK il y a un utilitaire nomm "CheckASC", 
grce auquel on peut trouver les codes ASCII des caractres.


/CLIP.TXT.REMOVE.ASK ..: Supprime dans le presse-papiers un caractre ou 
                         un texte  dfinir
/CLIP.TXT.REPLACE.ASK .: Remplace dans le presse-papiers un caractte ou 
------------------------ un texte  dfinir

Ces 2 commandes ouvrent une bote, dans laquelle on pourra effectuer le 
changement dsir.
D'autres informations se trouvent dans le texte "Historique du presse-
papiers".

Exemple: {/CLIP.TXT.REMOVE.ASK}
Exemple: {/CLIP.TXT.REPLACE.ASK}


/CLIP.TXT.REMOVE.TXT ..: Supprime le texte <txt> du presse-papiers
/CLIP.TXT.REPLACE.TXT .: Remplace dans le presse-papiers le 1er texte 
------------------------ par le 2me <txt>,<txt>

Exemple: {/CLIP.TXT.REMOVE.TXT abrv.: }

Dans ce scnario le texte "abrv. " sera supprim du presse-papiers, et 
galement par exemple "Abrv. ".

Exemple: {/CLIP.TXT.REPLACE.TXT example,Exemple}

Ce scnario remplace tous les mots "Example" par "Exemple".


/CLIP.TXT.SAVE file ...: Sauvegarde le texte contenu dans le presse-
------------------------ papiers dans un fichier-texte <file>

Exemple de scnario : 

1. Crez un bouton avec la commande : 
   {/CLIP.TXT.SAVE c:\mes documents\essai2.txt}
2. Copiez un texte dans le presse-papiers, puis cliquez sur le bouton.
3. Le fichier-texte "essai2" est cr dans C:\Mes documents avec le 
   contenu du presse-papiers.

On peut aussi utiliser cette commande en effaant d'abord le contenu 
du presse-papiers avec /CLIP.CLEAR, puis en ajoutant du texte avec 
/CLIP.TXT.APPEND.


/CLIP.TXT.SEND ........: Colle le texte-ASCII (.txt) du presse-papiers
------------------------ dans une application-texte

Cette commande fonctionne comme le "coller" [Ctrl]+[v], mme si celle-ci 
ne fonctionne pas. Elle peut tre utilise bien sr en complment de la 
commande /CLIP.TXT.LOAD file (voir plus haut).

Exemple: bouton droit "Val2Wrd" du profil "Stock"


/CLIP.TXT.SET txt .....: Copie un texte <txt> dans le presse-papiers
------------------------

Exemple: {/CLIP.TXT.SET http://www.freewarehits.de}


/CLIP.TXT.TAB>SPC no ..: Convertit dans le presse-papiers les tabulations 
------------------------ en nb. <no> d'espaces

Exemple: {/CLIP.TXT.TAB>SPC 8}


/CLIP.TXT.TRIM ........: Enlve les Espaces et les Tabulations au dbut 
------------------------ et  la fin du texte dans le presse-papiers

Cette commande peut tre trs utile lorsqu'un texte mal format est copi
dans le presse-papiers, comme c'est souvent le cas avec des pages Web.

Exemple: bouton "es/re/ta." du profil "Stock"

--> Conseil
Pour corriger des pages Web mal formates allez au site freewarehits.de 
pour tlcharger le logiciel gratuit "Copy & Trim" qui fait partie d'un 
paquet de plus de 30 utilitaires appel "ToolPackage".


/CLIP.TXT.VIEW ........: Affiche le contenu du presse-papiers (texte 
------------------------ seulement) dans l'Aperu interne de texte

Exemple: bouton "aperu" du profil "Stock"

